home *** CD-ROM | disk | FTP | other *** search
/ Cream of the Crop 20 / Cream of the Crop 20 (Terry Blount) (1996).iso / bbs / lndl27.zip / READ.ME < prev   
Text File  |  1996-06-26  |  9KB  |  258 lines
  1.  
  2. read.me for LNDL - Look at NoDeList
  3.  
  4. LNDL (C)1995, 1996 jim barchuk is copyrighted freeware.
  5.  
  6. Distribute at will.  No guarantees.
  7.  
  8. jim barchuk, 1:141/355@fidonet
  9.  
  10. | Items new or changed since the last general release have a '|' in the first
  11. | column.
  12.  
  13. *-*-* You may be SURPRISED at the results of the new LNDL.cfg.  See the
  14.       new exclusives there and the COMM echo msgs that support them.
  15.  
  16. ===
  17.  
  18. ;A Fido(r), FidoNet(r), and the dog with diskette are registered marks of Tom
  19. ;A Jennings and Fido Software.
  20.  
  21. ===
  22.  
  23. type
  24.      'LNDL' [cr]
  25.   or 'LNDL ?' [cr]
  26.   or 'LNDL -?' [cr]
  27.   or 'LNDL /?' [cr]
  28.   or 'LNDL djkgnfhye?mfjghruye' [cr]
  29.                                       for help screen
  30.  
  31. To save a copy of the help screen type 'LNDL > lndlhelp.txt' [cr].
  32.  
  33. ===
  34.  
  35. Note: LNDL can take a 'while' to run and can create a 'large' error file.
  36.       Running on a 386DX/40 on the full nodelist.012 1/13/96:
  37.  
  38.  with all command line switches enabled - 13 mins to run, 2 meg error file
  39.  with no  command line switches enabled -  7 mins to run, 600k error file
  40.  
  41. ===
  42.  
  43. What it does:
  44.  
  45. LNDL determines if a nodelist conforms to specification as defined in
  46. FTS-0005, a copy of that spec is enclosed.
  47.  
  48. LNDL reads a config file and a 'fidonet' nodelist and outputs a list of nodes
  49. and flags for those nodes that do not conform to the config.  See sample
  50. LNDL.CFG for config format.
  51.  
  52. ===
  53.  
  54. LNDL tests for the following:
  55.  
  56. False 'U'      : User flag that should be a 'real' flag.  For instance, if
  57.                 'valid Z19' is listed in LNDL.cfg and a node uses 'UZ19'.
  58.  
  59. Unknown        : Flags not listed as 'valid' or 'suggest'.
  60.  
  61. Exclusive      : One flag listed makes another flag redundant.  See LNDL.cfg.
  62.  
  63. Trailing ','   : Line should not end with a comma unless there are no flags
  64. |                following the speed.  A comma after the speed is required
  65. |                if there are no flags.
  66.  
  67. Embedded Space : Lines should contain no embedded spaces.  For example,
  68.                  'XA,CM, V32b,V42b' is reported as '?V32b'.
  69.  
  70. Duplicate      : A flag should not be listed twice in a nodelist line.
  71.  
  72. Isolated Hub   : Lines starting with 'Hub,' must have one or more 'vanilla'
  73.                  lines following it.
  74.  
  75. Non Dupe Host  : Lines starting with 'Zone,' 'Region,' 'Host,' or 'Hub,' must
  76.                  also have a 'vanilla node' duplicate (phone number) line
  77.                  within it's respective segment.
  78.  
  79.                  Default is to check for 'Hub,' dupe only ('strict' FTS-5).
  80.                  -h command line switch checks for others also.
  81.  
  82.              NOTE: there is a bug wherein this feature seems to work only
  83.                    on the full nodelist, not snipped segments.  Not sure
  84.                    why, will fix it soon.
  85.  
  86. Multiple 'X'   : Only one file update/request 'X' flag per line permitted.
  87.  
  88. Multiple 'U'   : User flags should appear as:
  89.                          - UFLAG1,FLAG2,FLAG3   - recommended
  90.                  or      - U,FLAG1,FLAG2,FLAG3  - allowed but not recommended
  91.                  but not - UFLAG1,UFLAG2,UFLAG3
  92.  
  93.                  The above is valid for Z1 only.
  94.                  The Z2 nodelist says that 'U,FLAG1,FLAG2' is preferred.
  95.                  I'll try to work in a command line switch for this.
  96.  
  97. Empty          : For example, 'FLAG1,FLAG2,,FLAG3,FLAG4'.
  98.  
  99. Naked 'U'      : Line ending with 'U' with no following flag.
  100.  
  101. Long 'U'       : User flags total maximum length is 32 chars.
  102.  
  103. Zone/Region/   : Within a nodelist, zone numbers must be unique.
  104. Host/Hub Dupe    Within a zone, region numbers must be unique.
  105.                  Within a zone, host numbers must be unique.
  106.                  Within a net, hub and node numbers must be unique.
  107.  
  108. Node Zero      : Lines should not start with ',0,'.
  109.  
  110. Out Of Range   : Lines must contain characters in the ASCII range of $21
  111.                  through $7E inclusive (decimal 33 through 126).
  112.                  Requires -a command line switch.
  113.                  Default is NO range checking.
  114.  
  115. Phone          : There must be at least two hyphens within the phone field,
  116.                  separating country, city/area code and number.
  117.  
  118. Speed          : The speed field is found immediately after the phone number
  119.                  and must be one found in the config file.
  120.  
  121. ===
  122.  
  123. The -k parameter will cause LNDL to keep count of various items: zones,
  124. regions, hosts, hubs, nodes, pvt, hold, down, speeds, and errors found.
  125.  
  126. ===
  127.  
  128. Config file limitations:
  129.  
  130.     Maximum valid flags = 256
  131.        "    suggest     = 256
  132.        "    exclusives  = 128
  133.        "    speeds      =  64
  134.  
  135. ===
  136.  
  137. Program limitations:
  138.  
  139.     Maximum non dupe hosts found =  850
  140.        "    flags per node       =   32
  141.  
  142.     Maximum zones per nodelist   =   32
  143.        "    regions per zone     =   64
  144.        "    hosts per region     = 1024
  145.        "    hubs per host        =   64
  146.        "    nodes per host       = 1024
  147.  
  148. ===
  149.  
  150. Flag checking may be performed 'case sensitive'.
  151. See LNDL.cfg for explanation.
  152.  
  153. Case sensitive flag checking requires -s command line switch.
  154. Default is NON case sensitive.
  155.  
  156. ===
  157.  
  158. LNDL is 'network independant'.  You can edit the config file for whatever
  159. flags and speeds are applicable to your zone or ftn.
  160.  
  161. ===
  162.  
  163. What it doesn't do:
  164.  
  165. LNDL will -not- write to your nodelist.  It writes to the screen, or to a '>'
  166. redirected file.
  167.  
  168. LNDL ignores DOWN, HOLD and PVT nodes.  None of these are normally dialable.
  169. HOLD and PVT nodes are normally routed -unless- they exist in your local
  170. PVTLIST, the format and maintenance of which is your responsibility.
  171.  
  172. LNDL ignores '#', '!' flags.
  173.  
  174. ===
  175.  
  176. Any problems, please send back to me a note including the error reported and
  177. any output file created.
  178.  
  179. Any suggestions, just ask.
  180.  
  181. A future version will have all program and config limits lifted.
  182.  
  183. A future version will test CRC accuracy if available.
  184.  
  185. ===
  186.  
  187. history
  188.  
  189. Jun 26, 1996 - 'If not case sensitive then (one flag = error)' bug fix.
  190. v2.7         - Added 'phone hyphen' test. Default is OFF.
  191.              - Removed Memmap, have never needed it, runs a tad quicker.
  192.              - Dropped a few 'controversial' exclusive flags in default
  193.                LNDL.CFG, this trims error output by 75%.
  194.  
  195. Mar 31, 1996 - 'One flag = always error' bug fix.
  196. v2.6g        - No exclusives in LNDL.CFG crashed.  Fixed.
  197.              - Wrong 'Address' bug fix in several places.
  198.              - Was -not- ignoring Down, Hold and Pvt nodes.  Fixed.
  199.              - Added 'Exclusive QMM X?' tests to LNDL.CFG.
  200.              - 'Speed Totals' formatting error.
  201.  
  202. Feb 03, 1996 - Memory (new/dispose) bug fix.
  203. v2.6f        - Cosmetic improvements to total counts.
  204.              - Added elapsed time.
  205.  
  206. Dec 31, 1995 - Multiple 'X' address bug fix.
  207. v2.6e        - Added FILE_ID.DIZ to distribution archive.
  208.  
  209. Dec 20, 1995 - Added -k keep count feature.
  210. v2.6d        - Updated 'exclusives' list in LNDL.cfg as advised in the COMM
  211.                echo.  See LNDL.cfg for details.
  212.  
  213. Nov 28, 1995 - Command line bug fix. [sigh]
  214. v2.5c        - Improved parameter reporting.
  215.  
  216. Nov 18, 1995 - Added -h switch.
  217. v2.5a
  218.  
  219. Nov 12, 1995 - Show duplicate flag.
  220. v2.4a        - Added wildcards to valid flags.  See LNDL.cfg.
  221.  
  222. Nov  9, 1995 - Host dupe bug fix, crashed on full nodelist.
  223. v2.3f        - 'Suggest' bug fix.
  224.              - 'Embedded Space' nit fix.
  225.              - 'Totals' nit fix.
  226.              - Added John Gohde's MEMMAP error debugging tool.
  227.              - Added Zone/Region/Host/Hub/Node dupe number test.
  228.              - Ignore fsc-0062 'Txy' flags.
  229.              - Added screen reporting to show program is running.
  230.  
  231. Nov  7, 1995 - Added 'Out Of Range' ASCII character test.
  232. v2.2a        - Added 'Node Zero' test, suggested by Leonard Erickson.
  233.              - Shortened 'Error Subtotals' report to make it easier to read.
  234.              - Added many notes to read.me.
  235.              - Added FTS-0005.ZIP to distribution file for those folks who
  236.                don't have a copy.
  237.  
  238. Nov  4, 1995 - Isolated hub bug fix, '-Totals- %' bug fix.
  239. v2.1c
  240.